home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / printing / mfps.arc / FITPS.MAN < prev    next >
Text File  |  1988-10-28  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. FITPS(local)        UNIX Programmer's Manual         FITPS(local)
  5.  
  6.  
  7.  
  8. NAME
  9.      fitps - Change dimensions and location of PostScript picture
  10.  
  11. SYNOPSIS
  12.      fitps [ -l_✓l_✓l_✓x,_✓l_✓l_✓y -u_✓u_✓r_✓x,_✓u_✓r_✓y -m_✓c|_✓i -F -D -o <_✓f_✓i_✓l_✓e_✓n_✓a_✓m_✓e>
  13.       ]  [ file ]
  14.  
  15. DESCRIPTION
  16.      _✓F_✓i_✓t_✓p_✓s facilitates the alteration of size and positioning of
  17.      a given PostScript program. The general procedure is to
  18.      transform the _✓b_✓o_✓u_✓n_✓d_✓i_✓n_✓g _✓b_✓o_✓x which is a natural property of a
  19.      plain PostScript program into another bounding box.  The
  20.      parameters of the intended bounding box must be supplied to
  21.      _✓f_✓i_✓t_✓p_✓s.  Information about the original bounding box of the
  22.      PostScript program must be contained in the %%BoundingBox:
  23.      llx lly urx ury header comment field of the PostScript pro-
  24.      gram. Bounding boxes are defined by the coordinates of the
  25.      lower-left and the upper-right corner. Coordinates of the
  26.      original bounding box are dimensioned in _✓n_✓a_✓t_✓u_✓r_✓a_✓l _✓P_✓o_✓s_✓t_✓S_✓c_✓r_✓i_✓p_✓t
  27.      _✓u_✓n_✓i_✓t_✓s, i.e. 1/72 inches. Metrics for the intended bounding
  28.      box may be specified in _✓c_✓e_✓n_✓t_✓i_✓m_✓e_✓t_✓e_✓r_✓s or _✓i_✓n_✓c_✓h_✓e_✓s. Values may be
  29.      given in integral or real format.
  30.  
  31.      _✓F_✓i_✓t_✓p_✓s can be supplied with the necessary parameters in two
  32.      ways: either in _✓b_✓a_✓t_✓c_✓h _✓m_✓o_✓d_✓e or in _✓i_✓n_✓t_✓e_✓r_✓a_✓c_✓t_✓i_✓v_✓e _✓m_✓o_✓d_✓e. In batch
  33.      mode, all parameters must be supplied from the command line.
  34.      In interactive mode, the user is asked for each parameter
  35.      one by one. This is convenient, because _✓f_✓i_✓t_✓p_✓s requires a lot
  36.      of parameters at the same time.  If _✓f_✓i_✓t_✓p_✓s detects an error
  37.      in command line usage, it automatically enters interactive
  38.      mode.
  39.  
  40.      The PostScript program resulting from the transformation of
  41.      the original program is sent to standard output unless the
  42.      name of an output file is specified.
  43.  
  44.      As the proportions of the original and the intended bounding
  45.      box are generally different, _✓f_✓i_✓t_✓p_✓s operates on a _✓c_✓l_✓o_✓s_✓e_✓s_✓t _✓f_✓i_✓t
  46.      basis, i.e. the scale factor for the entire picture is
  47.      selectet such that the picture will not extend the intended
  48.      bounding box.  There is, however,  a special option that
  49.      allows to completely fit the picture in the intended bound-
  50.      ing box, which results in a distortion of the picture.
  51.  
  52.      The following _✓o_✓p_✓t_✓i_✓o_✓n_✓s may be used with fitps:
  53.  
  54.      -l_✓l_✓l_✓x,_✓l_✓l_✓y
  55.           X- and Y-coordinates of the lower-left corner of the
  56.           intended bounding box. Values for X and Y are separated
  57.           by a comma (no white space).  Real numbers have a
  58.           decimal point, e.g 12.4, 10. or .22.
  59.  
  60.  
  61.  
  62.  
  63. Printed 10/16/87              fitps                             1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. FITPS(local)        UNIX Programmer's Manual         FITPS(local)
  71.  
  72.  
  73.  
  74.      -u_✓u_✓r_✓x,_✓u_✓r_✓y
  75.           X- and Y-coordinates of the upper-right corner of the
  76.           intended bounding box.
  77.  
  78.      -m_✓c|_✓i
  79.           Metric system for the coordinates. _✓c indicates centime-
  80.           ters, _✓i indicates inches. If this option is omitted,
  81.           the default metric system (in Europe: centimeters) is
  82.           assumed.
  83.  
  84.      -o   The output shall be directed into the file with the
  85.           given name.  If the filename is '-', or the option is
  86.           omitted, the output is sent to standard output.
  87.  
  88.      -D   If this option is set, _✓f_✓i_✓t_✓p_✓s projects the picture into
  89.           the entire area of the intended bounding box. This will
  90.           in almost any case rersult in a distortion of the ori-
  91.           ginal picture.
  92.  
  93.      -F   Operate in filter mode. If this option is set, the
  94.           PostScript program is read from standard input. This
  95.           works only on UNIX machines.
  96.  
  97. DIAGNOSTICS
  98.      _✓F_✓i_✓t_✓p_✓s complains if the input file does not look like
  99.      PostScript or if no bounding box information can be located.
  100.  
  101. SEE ALSO
  102.      mfps(1)
  103.  
  104. BUGS
  105.      _✓F_✓i_✓t_✓p_✓s makes the assumption, that the PostScript program
  106.      describes just one page. The result for multiple-page docu-
  107.      ments is undefined.
  108.  
  109. AUTHOR
  110.      Axel Mahler
  111.      Technical University Berlin
  112.  
  113.      _✓U_✓U_✓C_✓P:     axel@coma.uucp (unido!coma!axel)
  114.      _✓B_✓I_✓T_✓N_✓E_✓T:   axel@db0tui62
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Printed 10/16/87              fitps                             2
  130.  
  131.  
  132.  
  133.